home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / gipv301.zip / INSTALL.DOC < prev    next >
Text File  |  1992-03-30  |  9KB  |  193 lines
  1.                           Generic Install Program               Mar. 20, 1992
  2.  
  3.                                   ver 3.00a
  4.  
  5.                                      by
  6.  
  7.                            Kenneth E. Sandquist Jr.
  8.  
  9.                           --------------------------
  10.  
  11.      Generic Install Program (GIP) is a "programmers' tool" to allow you to
  12. install your software packages with a professional look!  After all, isn't
  13. the installation of your package the first thing people see?
  14.  
  15.      GIP has several nice features that can alleviate the hassle and extra
  16. code in your programs.  It allows for minimum memory amount checking, 
  17. available disk drive space, 32-bit CRC checking, and existing file and 
  18. directory checks!  All this is done in a nice, professional 3-D type screen.
  19.  
  20.      To use GIP, a file is required (INSTALL.LST) to tell GIP what files to
  21. install, where to install them, and file CRC's and sizes.
  22.  
  23.      To create the INSTALL.LST file, a program is included in this package
  24. appropriately named: CREATE.EXE. If you are using this version for the first
  25. time, just type 
  26.  
  27.         C:\GINSTALL> CREATE <RETURN>
  28.       
  29. CREATE will proceed to ask you several questions:
  30.  
  31.       1) Enter the name of your software package:
  32.          Type in the name of the software you are planning to install
  33.          with GIP.  If no name is desired, hit enter.
  34.       
  35.       2) Enter INSTALL directory name:
  36.          The name you type in here should be the directory you would prefer
  37.          your package to be installed to.
  38.  
  39.       3) Enter the executable name:
  40.          You should type the name of the main executable (the program that 
  41.          starts your software) of your package.  The default is NONE.
  42.  
  43.       4) Copy files to what floppy/hard drive?
  44.          Enter the disk drive you wish to transfer your package to.
  45.          A list of valid drives is provided.
  46.  
  47.       5) Enter minimum memory required:
  48.          This value should be the least amount of memory required for your
  49.          program to run.  The default is 384 kbytes.
  50.  
  51.          You are then given the opportunity to verify your answers and to 
  52.          make any changes.
  53.       
  54.       6) Which disk size is your program going to be installed from?
  55.          You are given 5 choices here:
  56.            a) 360k
  57.            b) 1.2M
  58.            c) 720k
  59.            d) 1.44M
  60.            e) UNLIMITED
  61.          Choose the format you are copying your files to (see question #3).
  62.          If you have less than this amount available on the disk, CREATE will
  63.          adjust the maximum space available accordingly.
  64.  
  65.  
  66.  
  67.  
  68. CREATE will now proceed to provide you with a file menu system to tag and
  69. copy files to the destination and create the INSTALL.LST file.  If you ever
  70. need help, just press F1.  A help window will pop up telling you what keys do
  71. what.  Pressing ESC any time during CREATE will abort!
  72.  
  73.      Use the space bar to tag files individually or use the ALT-T to "batch" 
  74. tag files, ALT-U to "batch" un-tag files, or ALT-R to reverse all tags - 
  75. files that were tagged are now cleared and files that were clear are now 
  76. tagged!  CREATE will keep track of the tagged byte count and warn you when 
  77. you have exceeded the amount of space available on the drive you are copying 
  78. files to!
  79.  
  80. **NOTE:
  81.    
  82.    The "Bytes tagged" and the "Adj. file size" are the amount of bytes 
  83.    that the file(s) will take up once transferred to disk and not the 
  84.    ACTUAL bytes!
  85.      
  86.      You can change directories and/or drives by tabbing over to the 
  87. directory window, selecting the drive/directory to change to and hitting 
  88. RETURN!  CREATE will read all of the files in that directory and display them
  89. for tagging! (By the way, CREATE will keep track of the files tagged for the
  90. disk number you are working on!)
  91.  
  92.      Once you have tagged all the files you want on the first disk, press    
  93. ALT-S to copy the files to the drive you specified.  You do this until you
  94. have copied all files to all disks.  To complete the CREATE process, hit F10
  95. and CREATE will make the INSTALL.LST file on disk 1 (CREATE will prompt you
  96. to insert disk 1 in the specified drive!)!  
  97.  
  98. ***NOTE:
  99.    
  100.    CREATE will reserve 10240 bytes on disk 1 for the INSTALL.LST file plus
  101.    51200 bytes for INSTALL.EXE.  This is mandatory to insure that there is 
  102.    enough room to complete the CREATE process and cannot be changed!
  103.  
  104.      When you hit F10, a message may come up and tell you that you have not
  105. yet copied the program INSTALL.EXE over to the specified drive.  This is 
  106. quite normal if you do not want to include this program with your install 
  107. set.  (If you use CREATE to copy INSTALL.EXE to the drive you specified, it 
  108. will be included in the install.  Otherwise, copy it over manually and it will
  109. not be included!)
  110.  
  111. That's it!
  112.  
  113.      The CREATE process is now complete!  After you have become familiar with 
  114. the CREATE process, you can type:
  115.  
  116.         C:\GINSTALL> CREATE /NOH <RETURN>
  117.  
  118. The /NOH stands for "no help"...When CREATE displays the file system, it no
  119. longer displays the help screen first.  F1 will still display the help 
  120. window during the process!
  121.  
  122.      Once you have distributed your software with the INSTALL...
  123.  
  124.      Have the user type INSTALL at the DOS prompt and INSTALL will take over
  125. with little or no help from the user.  INSTALL will ask the user to enter the
  126. drive to install onto (default = C:).  Then it will ask them to enter the
  127.  
  128.  
  129.  
  130. directory name where they would like to install your package (your preferred
  131. directory name is shown as the default...they can either hit ENTER or type in
  132. their own directory!).  If the specified directory already exists on the
  133. drive, the installer is warned that it exists and is prompted to either quit
  134. or continue to use that directory.  The next, and in most cases the last,
  135. step is to hit any key to start the install.  That's it!  If INSTALL comes
  136. across a filename that already exists in the path specified, the user is
  137. prompted to overwrite the file.  They can enter 1 of 3 answers:
  138.  
  139.       1) Y - yes, I want to overwrite this file!
  140.       2) N - no, skip this file and go on!
  141.       3) A - yes, I want to overwrite this file and all others that may exist!
  142.  
  143. At any time during the install, the user can hit the ESC key to stop the
  144. program and prompt them to abort.
  145.  
  146. On multiple disk install sets:
  147.      
  148.      In the cases where your package spans more than one floppy, INSTALL will
  149. prompt the user to insert disk #? into disk ?:...The disks created by the 
  150. CREATE process are coded as to which disk number each one is.  So the disk 
  151. labels should include sequential numbers to correlate to each disk!
  152.  
  153. ERRORS:
  154.                                            
  155.      There is only one message that, under normal circumstances, should appear
  156. in the MESSAGES window and that is XXXXXXXX.XXX Bad CRC!  This is not a
  157. serious error; However, it is advisable to have the installer inform you of
  158. this error and what file it occurred on.  What this error means is that the
  159. file in error no longer matches the CRC value in the INSTALL.LST file.  There
  160. could be several reasons for this: bad disk, old CRC value in the list, or the
  161. file has been altered.  It's up to you, the programmer, to decide what the
  162. user should do when this error occurs...INSTALL will still install the file
  163. with just a warning to the user!
  164.  
  165. -----------------------------------------------------------------------------
  166.                            
  167.                            Who is Vision Software?
  168.  
  169.      Vision Software was created by the author Kenneth E. Sandquist Jr.
  170.  
  171.                             3187A Aqueduct Drive
  172.                             Lexington, KY 40517
  173.  
  174.     The author can be reached at three major boards in the US:
  175.  
  176.         Vern Beurg's Motherboard.......1-707-778-8944
  177.                                     or 1-707-778-8841
  178.         
  179.         Ken Prevo's dBasic's Toolkit...1-219-696-3415
  180.                                     
  181.         Don Bodley's Professional BBS..1-606-269-1565
  182. -----------------------------------------------------------------------------
  183.  
  184.                                  Disclaimer
  185.  
  186.           INSTALL is distributed as-is.  The author disclaims all
  187.           warranties, expressed or implied.  The author will assume
  188.           no liability for damages either from the direct use of this
  189.           product or as a consequence of the use of this product.
  190.  
  191. -----------------------------------------------------------------------------
  192.  
  193.